Check App State

UiPath.UIAutomationNext.Activities.NCheckState

Description

Vérifie l'état d'une application ou d'un navigateur Web en vérifiant si un élément apparaît ou disparaît de l'interface utilisateur, et peut exécuter un ensemble d'activités si l'élément est trouvé et un autre ensemble d'activités si l'élément est introuvable.

Il peut surveiller les modifications d’une application entière, et pas seulement d’un seul élément d’IU.

Il peut être utilisé comme condition de l’activité Étendue de nouvelle tentative (Retry Scope ) et peut également être utilisé à la fois à l’intérieur et à l’extérieur d’une activité Utiliser l'application/le navigateur .

Cette activité est compatible avec le référentiel d’objets.

Compatibilité du projet

Windows - Héritage | Windows | Multiplateforme

Windows - Héritage, configuration Windows

Module Designer

• Cliquez sur Indiquer dans l'application/le navigateur (Indicate in App/Browser) pour indiquer l'élément d'IU à utiliser comme cible.

  Après avoir indiqué la cible, sélectionnez le menu pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.
  • Supprimer la capture d'écran d'information (Remove informative screenshot ) - Supprime la capture d'écran de l'application cible ou de la page Web.
  • Ajouter au référentiel d’objets (Add to Object Repository ) : ajoutez l’élément d’IU actuel à un projet de bibliothèque, à partir duquel il pourra être réutilisé tout au long de votre processus d’automatisation.

• Attendre (Attente) : sélectionnez l'événement à utiliser pour déterminer l'état de l'application ou du navigateur :

  • Élément à apparaître : attendez que l'élément apparaisse dans l'interface utilisateur. Si vous sélectionnez cette option :

    • Ajoutez les activités à exécuter si l'élément apparaît dans le bloc La cible apparaît .
    • Ajoutez les activités à exécuter si l'élément n'apparaît pas dans le bloc La cible n'apparaît pas .

  • Élément à disparaître - attendez que l'élément disparaisse de l'interface utilisateur. Si vous sélectionnez cette option :

    • Ajoutez les activités à exécuter si l'élément disparaît dans le bloc la cible disparaît.
    • Ajoutez les activités à exécuter si l'élément ne disparaît pas dans le bloc la cible ne disparaît pas.
• Secondes (Secondes) - Durée d’attente de l’apparition ou de la disparition de l’élément avant l’exécution de l’un des deux blocs d’activités. Vous pouvez choisir une valeur prédéterminée dans le menu déroulant. La valeur par défaut est 5 secondes.
• Cliquez sur Basculer les branches dans le corps de l'activité pour configurer la visibilité des conteneurs La cible apparaît et La cible n'apparaît pas dans lesquels vous pouvez ajouter des activités à exécuter, en fonction de l'état. Vous pouvez utiliser les deux conteneurs, l'un d'entre eux ou aucun. Par défaut, les deux blocs sont visibles.

Panneau propriétés

Commun

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur. Un nom d'affichage est automatiquement généré lorsque vous indiquez une cible.

Entrée

• Cible (Target) - L'élément cible. L’élément cible doit être défini. Avant d'être indiqué à l'écran, ce champ est défini sur (null). Une fois la cible indiquée, toutes les propriétés concernant l'élément qui a été indiqué sont affichées.
  • Type decontrôle CV (CV Control type ) : indique le type de contrôle identifié à l'aide de Computer Vision.
  • Texte CV - Indique le texte identifié à l’aide de Computer Vision.
  • Sélecteur de correspondances approximatives : les paramètres du sélecteur de correspondances approximatives.
  • Texte natif : le texte utilisé pour identifier l'élément d'IU.
  • Sites Web réactifs - Activez la mise en page des sites Web réactifs.
  • Sélecteur strict : le sélecteur strict généré pour l'élément d'IU.
  • Méthodes de ciblage : les types de sélecteurs à utiliser pour identifier l'élément. Cette propriété peut recevoir n'importe quelle combinaison à partir du menu déroulant :
    • Aucun (None)
    • Sélecteur strict
    • Sélecteur de correspondances approximatives
    • Image
    • Texte natif
    • Computer Vision
  • Contrôle de visibilité (Visibility check ) - Vérifie si l'élément d'IU est visible ou non. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • Aucun : ne vérifie pas la visibilité.
    • Interactif (pour le Sélecteur de correspondances approximatives) : option par défaut. Vérifie si l'élément est potentiellement visible, en ignorant le défilement de la page et les obstructions par d'autres applications, ou le fait que l'application est réduite. Cette vérification est utile lorsque vous essayez de vous assurer que vous ne ciblez pas des éléments invisibles qui existent dans le DOM mais qui sont masqués.
    • Entièrement visible : vérifie si l'élément d'IU est visible ou non.
  • Attendre le chargement de la page : avant d'effectuer les Actions, attendez que l'application soit prête à accepter les entrées. Vous pouvez choisir l’une des trois options suivantes dans le menu déroulant :
    • None : n’attend pas que la cible soit prête.
    • Interactif : attend qu'une partie de l'application soit prête.
    • Complète  : attend que l'application entière soit prête.
  • Sélecteur de fenêtre (Instance d'application) : le sélecteur utilisé pour la fenêtre d'application. Uniquement applicable lorsque le mode d'attachement de fenêtre est défini sur Instance d'application (Application instance).

Élément d’entrée/de sortie

• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.

Divers

• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False.

Options

• Délai d'attente (secondes) : voir secondes dans le panneau Concepteur.
• Attendre (apparaître/disparaître) : voir Attendre dans le panneau Concepteur.

Sortie

• Résultat : indique si l'élément existe ou non. Ce champ prend uniquement en charge les variables Boolean . Vous pouvez également enregistrer cette valeur (True/False) pour une utilisation ultérieure, ou l'enregistrer dans une cellule d'un fichier Excel parent ou dans le bloc-notes de projet.

Configuration multiplateforme

• Étendue du travail (Work in scope ) - Choisissez l'onglet du navigateur générant le rendu de l'application Web à automatiser.

• Indiquer la cible à l’écran : indiquez l’élément d’IU à utiliser comme cible.

  Après avoir indiqué la cible, sélectionnez le bouton Plus pour accéder aux options suivantes :

  • Indiquer la cible à l'écran : Indiquez à nouveau la cible.
  • Modifier la cible (Edit target ) : ouvre le mode de sélection pour configurer la cible.

• Attendre (apparaître/disparaître) - Sélectionnez l'événement à utiliser pour déterminer l'état de l'application ou du navigateur :

  • Élément à apparaître : attendez que l'élément apparaisse dans l'interface utilisateur. Si vous sélectionnez cette option :

    • Ajoutez les activités à exécuter si l'élément apparaît dans le bloc Si existe (IfExists) .
    • Ajoutez les activités à exécuter si l'élément n'apparaît pas dans le bloc Si non existant (IfNotExists) .

  • Élément à disparaître - attendez que l'élément disparaisse de l'interface utilisateur. Si vous sélectionnez cette option :

    • Ajoutez les activités à exécuter si l'élément disparaît dans le bloc Si existe (IfExists) .
    • Ajoutez les activités à exécuter si l'élément ne disparaît pas dans le bloc Si non existant (IfNotExists) .
• Timeout (seconds) : le délai d'attente pour que l'élément apparaisse ou disparaisse avant d'exécuter l'un des deux blocs d'activités. La valeur par défaut est 5 secondes.

Options supplémentaires

Horaires

• Délai avant (Delay before) : Délai (en secondes) entre le moment où l'activité précédente est terminée et le moment où cette activité commence à effectuer des opérations. La valeur par défaut est 0,2 seconde. L'ajout d'un délai entre les activités garantit qu'une activité dispose de suffisamment de temps pour se terminer avant le début de l'activité suivante.

Options

• Vérifier la visibilité : lorsqu’elle est activée, l’activité vérifie également si l’élément d’IU est visible ou non.

Entrée/sortie

• État (State) - Valeur vraie ou fausse indiquant l'état détecté de la cible.
• Élément d'entrée (Input element ) : l'élément de l'interface utilisateur sur lequel l'activité est exécutée, stocké dans un objet UIElement . Ce champ ne prend en charge que les objets UIElement . Cet objet peut être obtenu à partir du champ de propriété Élément de sortie ( Output Element ) d’autres activités UI Automation.
• Élément de sortie (Output element ) : génère un élément d'IU cible et le stocke dans un objet UIElement , qui peut ensuite être utilisé pour cibler le même élément avec d'autres activités.